Appendix B - Reference data

Qualisys provides a demo reference data. The reference sample demographics is described at Report Center when selecting a reference sample. It is a good practice to establish a reference data set for your lab. This ensures that it reflects your normal procedures (e.g. placement of anatomical markers) and lab environment (e.g. gait speed depending on lab size). This section describes how to create the reference database and use it in the reports.

Note: Reference data created by following steps can be used in Visual3D report, Word report and online web report. Reference data in offline web report cannot be changed, thought.

Reference data set is created in Report Center, so make sure you have access to report.qualisys.com. Reports must be uploaded to Report Center first to be able to include them to reference data set. Please review each report to ensure that only good data is being included. If you wish to deselect individual trials, take a note of a wrong trial(s). Removal will be done later in the process. Once you know which reports you would like to include, follow these steps:

Open Report Center, select all reports that you would like to include and click 'Ref+' icon.
After clicking Ref+ icon, new window opens. Specify name of data set and optionally deselect invalid trials. Then click 'Add & close' button.
If the list of reports that you want to include spans across several pages, repeat step 1 and 2.
After all reports are added to the database, go to Settings > Reference data and click 'View / Edit' button next to your data set.
On following page you can review the details of data set, specify properties (name of data set and detailed description) , add or remove reports, define report groups and specify options how reference data will be shown in the reports. Once everything is set up, click 'Save changes' button at the bottom of the screen.
From now on, reference data set can be selected for each report. Open the report, and under Report data open drop down list and select desired reference sample.
In order to use same reference data in Visual3D report, it is possible to export reference sample into .p2d format by clicking 'Download p2d' button on top of the page mentioned in step 5. Data is saved as a .zip file.
Unzip it to any folder. Make sure that unzipping was successful and .p2d files are not empty.
Open new instance of Visual3D. (It is important to start with a new instance of Visual3D to avoid situation when pipeline already includes some commands.)
Open Pipeline Workshop in Visual3D. Go to [your project]Templates\Assets\Visual3D Normatives and open create_normatives_vnd.v3s in Pipeline Workshop.
Execute the pipeline.
Visual3D will ask for directory where unzipped p2d signals reside. Processing should finish without any errors or warnings. You can close Pipeline Workshop after the processing is finished.
After the pipeline is processed, navigate to GLOBAL workspace and find P2D folder and PROCESSED subfolder.
Right click on PROCESSED folder, select 'Export Folder to Normal Database (.vnd)' and save .vnd file to [your project]\Templates\Assets\Visual3D Normatives. There can be two reference sets, one for kinematics and kinetics and the second one for EMG. This is useful when EMG reference sample is not created from the same patients that were use to generate kinematic/kinetics sample. If your reference data set includes EMG signals as well, it is necessary to export second .vnd file for EMG signals. It can contain all reference signals (including kinematics and kinetics) or only EMG signals. It also must be stored at [your project]\Templates\Assets\Visual3D Normatives.
In [your project]\Templates\setttings.php, under '//Normative data.' specify the name of .vnd file to be used in variable $normative_file. There is an option to use separate reference sample for adults and children and specify a default one. EMG reference data file is set separately. See variable $emg_normative_file. When EMG reference data set is set to 'Default', the default EMG reference set is used as provided with the module. There are two default EMG reference sets available. For Noraxon users, the data provided by Noraxon are used. For every other used the default EMG reference set is the one provided by Delsys. In order to use custom reference sample created in steps above, change $emg_normative_file to the .vnd filename as saved in previous step 14.